Molconn-Z 3.50 Manual: Chapter 3

CHAPTER 3

Getting Started

Installation of the Molconn-Z software package on a PC,or unix machine consists of (1) setting up the appropriate (sub)directory for Molconn-Z and (2) copying the files into that (sub)directory.


PC/DOS Installation Procedure

The Molconn-Z software is supplied on floppy diskettes or cassettes or tapes. The list of files is given on the next page. Installation on the PC consists of loading the files from the floppy to a directory designated for Molconn-Z. The MOLCONNZ.EXE file is ready for execution. This compiled version was prepared by Microsoft FORTRAN, version 5.0.

  1. Directory for Molconn-Z

    Before the software is loaded into your system, setup the (sub)directory which will house the software materials, the executable module, and example input/output files. See the table below.

    MKDIR  C:\MOLCONNZ\
    

    NOTE: It is essential that the Molconn-Z software be placed in a subdirectory with this name.

    Enter that (sub)directory and prepare to load the Molconn-Z files from the source disk or tape.

    CD C:\MOLCONNZ\
    
  2. Load disk/tape

    Use the proper command(s) to copy all files into designated (sub)directory. Do a directory command to determine that all the files have been loaded.

    See the directory listing for a copy of the contents of the software file directory.

    COPY A:*.*  C:
    

    Examine the directory of C:\MOLCONNZ to determine whether the copy command has been executed successfully.

  3. Test Run Molconn-Z

    To determine that your software is properly executing, execute one or more test runs of Molconn-Z.

    MOLCONNZ
    

    You may run Molconn-Z with any one of several of the example input file(s). Use of SMILES.B, MDL.B or SAMPLE.B is recommended. If an error is encountered, check Chapter 5 for the proper Menu option for the the .B files. See Chapter 4 for specific information on executing Molconn-Z.

    Several example input files are supplied, as follows:

      a. SAMPLE.B, using the MOLCONN connection table format
      b. SMILES.B, using the SMILES code format
      c. CHX.B, using the ChemDesign CSSR file format
      d. CDRAW.B, using the CHEMDRAW file format
      e. MDL.B, using the MDL Molfile format
      f. SDF.B, using the MDL SDFile format

    The preliminary test of Molconn-Z may be done using some of the above example files, such as SMILES.B , MDL.B or SAMPLE.B, or as many others as the user may wish to test. To execute Molconn-Z for each of these files, it is necessary to exercise the MENU option in which file format is specified. See MENU listings given below and further information in Chapter 5.

    In the software supplied with Molconn-Z, example output listing files are also included for each of the .B file and are labeled with the same file name and the extension L. Compare your output to the example output files to determine program performance. In the example files delivered in the Molconn-Z package, all the output options have been selected for the .L file and all the records have been selected for the .S file.

  4. Additional Information

    If the user is not interested in some of the file formats, the corresponding .B, .L and .S files should be deleted at this time. There are many other program options which the user may exercise; these are described in Chapter 5. The user should consider printing out the .B, .L and .S files at this time for future reference.

    Consideration should be given to the manner of use of the OPTION.DAT file when several users may access the same file.


Unix Installation Procedure

A few modifications to Molconn-Z have been made for the UNIX environment. One is that there are some UNIX environmental variables defined that will make it easier to run Molconn-Z in a multiple-user environment. One of these, $MCONN_OPT, will point to files containing each user's customization of Molconn-Z. The control options file, called OPTION.DAT in the PC/DOS version of Molconn-Z, has been renamed mconn_option.std.
  1. Directory for Molconn-Z

    The UNIX distribution of Molconn-Z is on a tape tar set. Please create a directory, mkdir eduSoft under /usr or another convenient location which will be the root directory for this product and unload the tape (tar xov) here.

  2. License Keys

    Install the Molconn-Z License Keys(s) as described on the included (hardcopy) documentation or on-line.

  3. Modify unix environment

    Edit the appropriate file in /usr/eduSoft/eslc/lib (see table below) to correct the entry for the actual location of $EDUSOFT_ROOT.

    Product(s) Platform cshrc profile
    Molconn-Z 3.50 r4000 cshrc_molconnz_r4 profile_molconnz_r4
    r5000 cshrc_molconnz profile_molconnz
    r8000, r10000, r12000 cshrc_molconnz_r8 profile_molconnz_r8
    HintLogP 2.30 & Molconn-Z 3.50 r4000 cshrc_hintlogp+molconnz_r4 profile_hintlogp+molconnz_r4
    r5000 cshrc_hintlogp+molconnz profile_hintlogp+molconnz
    r8000, r10000, r12000 cshrc_hintlogp+molconnz_r8 profile_hintlogp+molconnz_r8

  4. User Setup

    Each user must:

    • "source" the above resource file; e.g., for cshell users add the line
      source /usr/eduSoft/eslc/lib/cshrc_molconnz_r4 to your $HOME/.cshrc if you are using the r4000 platform.
    • create a molconnz and load a resource directory ($HOME/.molconnz). To do this type
      MCONN_USER to the unix prompt.
    • To run Molconn-Z, type $MCONN_RUN/molconnz.

  5. Test Molconn-Z as described in 3 above

    (Note that the unix filenames are all lowercase.)


Directory: Contents of the Molconn-Z Software

The following is a listing of the directory of the contents which the Molconn-Z software contains (shown here for a PC). It is useful to create and printout the directory listing for the account in which Molconn-Z is installed. Comparison can then be made with this listing for completeness of the software package.

Unix File Name DOS File Name File Description
bin/installMolconnZUsern/ashell file to create user's
options files
bin/make_demo.cshn/ashell file to create a user
demo directory
bin/molconnzMOLCONNZ.EXE MOLCONNZ executable file
demo/4clbiphe.tbl4CLBIPHE.TBL Molecule file for CDRAW.B
demo/acetica.cssACETICAC.CSS Molecule file for CHX.B
demo/cdraw.bCDRAW.B .B file, CHEMDRAW file format
demo/cdraw.eCDRAW.E .E file with CDRAW.B as input
demo/cdraw.lCDRAW.L .L file with CDRAW.B as input
demo/cdraw.sCDRAW.S .S file with CDRAW.B as input
demo/clphenol.molCLPHENOL.MOL molecule file for MDL.B
demo/chx.bCHX.B .B file, ChemDesign file format
demo/chx.eCHX.E .E file with CHX.B as input
demo/chx.lCHX.L .L file with CHX.B as input
demo/chx.sCHX.S .S file with CHX.B as input
demo/clbenzca.cssCLBENZCA.CSS Molecule file for CHX.B
demo/cnphenol.molCNPHENOL.MOL molecule file for MDL.B
demo/ethanol.cssETHANOL.CSS Molecule file for CHX.B
demo/mdl.bMDL.B .B file, MDL MOL file format
demo/mdl.eMDL.E .E file with MDL.B as input
demo/mdl.lMDL.L .L file with MDL.B as input
demo/mdl.sMDL.S .S file with MDL.B as input
demo/nnphenol.molNNPHENOL.MOL molecule file for MDL.B
demo/phenol.molPHENOL.MOL molecule file for MDL.B
demo/prop_acd.tblPROP_ACD.TBL molecule file for CDRAW.B
demo/pyridin0.tblPYRIDIN0.TBL molecule file for CDRAW.B
demo/pyridine.tblPYRIDINE.TBL molecule file for CDRAW.B
demo/sample.bSAMPLE.B .B file, MOLCONNX file format
demo/sample.eSAMPLE.E .E file with SAMPLE.B as input
demo/sample.lSAMPLE.L .L file with SAMPLE.B as input
demo/sample.sSAMPLE.S .S file with SAMPLE.B as input
demo/sdf.bSDF.B .B file for SDFile input format
demo/sdf.lSDF.L .L file with SDF.B as input
demo/smiles.bSMILES.B .B file, SMILES code format
demo/smallmol.smin/a sample SMILES file in Daylight format
demo/smiles.bSMILES.B .B file, SMILES code format
demo/smiles.eSMILES.E .E file with SMILES.B as input
demo/smiles.lSMILES.L .L file with SMILES.B as input
demo/smiles.sSMILES.S .S file with SMILES.B as input
demo/smiles.subSMILES.SUB .SUB file with SMILES.B as input
demo/snphenol.molSNPHENOL.MOL molecule file for MDL.B
installuser/mconn_option.stdOPTION.DAT file of program MENU option variables
installuser/mconn_option.orgOPTION.ORG backup copy of OPTION.DAT
lib/cshrcn/amolconnz resource file for csh
lib/profilen/amolconnz resource file for sh
tables/sasinpae.txtSASINPAE.TXT file with .E file format for SAS input,
for all bond types
tables/sasinpoe.txtSASINPOE.TXT file with .E file format for SAS input,
for only organic bond types
tables/sasinpz.txtSASINPZ.TXT file with .S file format for SAS input
tables/spl_atom_definitions.datn/aequivalence files for Sybyl atom types
n/aPARAM.DATCompiler and array size options


Sample MENU displays for Molconn-Z

For use in the test run of Molconn-Z, samples of the program option Menus are given below, including the default value for each option. For specific information on each Menu, see Chapter 5.

1. Main MENU



                          MOLCONNZ PROGRAM OPTIONS
                  Enter Number for the Desired Option Change
                      

 1- Input File (Molconn/SMILES code/
                Molfile/SDFile/CHEM-X)       (BFILE)  <C>
 2- Topological State Algorithm (1 to 6)     (IFUNCT) <4>
 3- Number of E-State Values in S File       (NSTATE) <90>
 4- Output to Bond Type File (A, O, I, N)    (ETOUT)  <O>
 5- Full Job or Only Output to Verify Input  (FULL)   <Y>
 6- Maximum Order of Chi Calculated          (MAXORD) <100>
    Output File Selections
 7- Output .S Index File                     (ITEXT)  <Y>
 8- Output .L Listing File (Screen Output)   (FAST)   <N>
 9- Output .E Bond Type E-state  File       (EDGECALC)<Y>
 10- Output Distance/Connectivity Matrices   (AFILE)  <N>
 11- Select FIRST SubMENU on Program Control                   
 12- Select SECOND SubMENU on Listing File Contents            
 13- Quit Menu .............Proceed with Calculations <Return>


 Please Enter Desired Option (1 to 14 or RETURN): 

2. Control Submenu


  1- Topological Symmetry Perception          (KSYM)   <Y>
  2- Field Delimiter                          (DLM)    <,>
  3- Maximum Order of Chi Output to File      (MOFILE) <10>
  4- Sign of Fluorine Contribution            (IFSIGN) <+>
  5- Molecular Connectivity Algorithm
      (Standard/Topological State Algorithm)  (CTYPE)  <R>
  6- Topological State Algorithm Type         (STYPE)  <G>
  7- Print Seclected Subgraphs       (ITERM,SORDER)  <N  4>
  8- Records output to .S file                (NRECS)  <48>
  9- Marker at end of each .S file line       (MARK)   <  >
 10- Quit SubMENU . . Return to Main Menu                     
 11- Quit SubMenu . . Proceed with Calculations       <Return>


 Please Enter Desired Option (1 to 11 or RETURN): 

3. Output Listing Submenu



 This SubMENU contains options for selecting output
              to be included in the output listing file (.L)
 A table of atom identification is always included 
  
   YOU MAY SELECT EACH OUTPUT BLOCK TO BE PRINTED <Y>
                             OR NOT TO BE PRINTED <N>
 1- Atom Symmetry Classification                (OUT1) <Y>
 2- Table of subgraph counts                    (OUT2) <Y>
 3- Table of Connectivity and kappa indexes     (OUT3) <Y>
 4- Total Topological Index and Wiener Indexes  (OUT4) <Y>
 5- Information Indexes and ad hoc parameters   (OUT5) <Y>

 Please, enter the number of an output block
                   whose print status you wish to change.
         >>>  Just push RETURN to go back to the MAIN MENU <

 Enter the number (or RETURN) : 


NOTE: These options are stored as values for corresponding variables in the file OPTION.DAT. Clearly, the integrity of this file must be protected. When the user requests that an option be changed 'permanently', the file OPTION.DAT is rewritten.

In the unix, "multiuser-environment" each user has his own copy of mconn_option.std which resides in a resource directory .molconnz, but it is still important for this file to be protected against corruption.


Added Unix Features and Options

There is an added feature of the UNIX versions of Molconn-Z that allows rapid processing of large files in a batch-like mode. By listing the input (.B file) and output (.S file) as arguments when initiating Molconn-Z, e.g., as:
$MCONN_RUN/molconnz test.b test.s,
Molconn-Z will run without further user interaction. Note that you must have the Molconn-Z control parameters (mconn_option.std) set to the correct input file format and to create the .S file as the only output.

Daylight Toolkit Option

The SGI and (potentially) some other UNIX versions of standalone Molconn-Z have the added capability of reading and decoding SMILES files using the Daylight Toolkit. This is an optional feature that requires additional licensing from eduSoft, LC/Hall Associates and a run-time SMILES Toolkit license from Daylight Chemical Information Systems, Inc. Each record of the Daylight SMILES files, which are generally named with the .smi extension, is simply a SMILES String followed by the Molecule Name (space delimited). There is no file termination code.